ShippingOptions API

1.0.x
(0 reviews)

Customs charges options

The customs_charges_options field identifies the available duties and taxes payment arrangements for each eligible international service.

Use the returned value when creating Parcel Label V3 requests to ensure the selected service and customs charges option are valid. When this field is returned, include the selected customs charges option in the Parcel Label V3 request.

System behaviour:

If both DDP and DAP are returned for a service, you must provide one option only. To send using DDP service, the request must include incoterm "DDP" and the applicable method available for the DDP service.

If incoterm “DDP" is not provided in the label request, the label will be created as DAP where DAP is available and DDP is not enforced for the service.

If only DDP or only DAP is returned for a service, that option will be applied regardless of the value provided in the request.

See Sending with Delivered Duty Paid | NZ Post find out the availability of DDP or DAP for the destination country and service.

FieldDescriptionTypeValid Values / Behaviour
incotermDefines who is responsible for duties and taxes.StringDDP (Delivered Duty Paid), DAP (Delivered At Place)
methodsValid duty and tax handling methods for the selected incoterm.ArrayFor DDP:
• TAX_NZP_REMIT - means NZ Post will arrange EU VAT remittance via its IOSS number, with the VAT amount charged to your account.
• TAX_SENDER_REMIT - means you will provide your own IOSS number and arrange EU VAT remittance directly. Please note this is applicable to only EU contries with DDP service. Please visit https://nzpost.co.nz/business/shipping-internationally/sending-with-delivered-duties-paid for more information.
• NZP_EXPRESS_DTP - NZ Post partners calculate duties and taxes and bill the sender through standard billing.


For DAP:
• COLLECT_FROM_RECEIVER - Duties and taxes (if applicable) are collected from the receiver in the destination country.

Example 1: Service supports both DAP and DDP


"customs_charges_options": [
  {
    "incoterm": "DAP",
    "methods": [
      "COLLECT_FROM_RECEIVER"
    ]
  },
  {
    "incoterm": "DDP",
    "methods": [
      "TAX_NZP_REMIT",
      "TAX_SENDER_REMIT"
    ]
  }
]

Example 2: Service supports DDP only


"customs_charges_options": [
  {
    "incoterm": "DDP",
    "methods": [
      "TAX_NZP_REMIT",
      "TAX_SENDER_REMIT"
    ]
  }
]

Example 3: Service supports DDP only


"customs_charges_options": [
  {
    "incoterm": "DDP",
    "methods": [
      "NZP_EXPRESS_DTP"
    ]
  }
]

Example 3: Service supports DAP only



"customs_charges_options": [
  {
    "incoterm": "DAP",
    "methods": [
      "COLLECT_FROM_RECEIVER"
    ]
  }
]

Reviews